home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / ansit100.zip / ANSITDOC.ENG < prev    next >
Text File  |  1992-05-01  |  17KB  |  362 lines
  1.  
  2.             ██████▄
  3.             ███  ██ ████▄ █▄   ████▄ ██     █▄ █████▄ █████▄ █████▄
  4.             ███  ██ ██  █ ██   ██    ██     ██ ██   █ ██   █ ██
  5.             ███▄▄██ ██  █ ██   ██▄▄  ██  █  ██ ██▄▄▄█ ██▄▄▄█ ██▄▄
  6.    ▓▓▓▓▓▓▓▓▓███░░░▓▓██░░█░██░░▓██░░▓▓██░▓█░▓██░██░░▓█░██░░█░▓██░░▓▓▓▓▓▓▓▓▓▓▓▓
  7.    ▓▓       ███     ██▄▄█ ██▄▄ ██▄▄▄ ██▄▄█▄▄██ ██   █ ██  █▄ ██▄▄▄▄        ▓▓
  8.    ▓▓                                                                      ▓▓
  9.    ▓▓                             PRESENTS                                 ▓▓
  10.    ▓▓                                                                      ▓▓
  11.    ▓▓                                                                      ▓▓
  12.    ▓▓                        ANSIT!   Version 1.00                         ▓▓
  13.    ▓▓                                                                      ▓▓
  14.    ▓▓                 Copyright (c) 1992 Steve Danielsson                  ▓▓
  15.    ▓▓                                                                      ▓▓
  16.    ▓▓                       BENCHMARK DOCUMENTATION                        ▓▓
  17.    ▓▓                                                                      ▓▓
  18.    ▓▓                                                                      ▓▓
  19.    ▓▓                                                                      ▓▓
  20.    ▓▓                                                                      ▓▓
  21.    ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                           CONTENTS OF THIS FILE
  28.                           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  29.  
  30.  
  31.   OVERVIEW.................... What ANSIT is and why you want to use it.
  32.  
  33.   USAGE....................... How to use the program.
  34.  
  35.   BENCHMARK DESCRIPTION....... Detailed description of the tests
  36.                                performed by ANSIT.
  37.  
  38.   ADDITIONAL NOTES............ A few notes on the interpretation of
  39.                                the benchmark results.
  40.  
  41.   ADVANCED OPTIONS............ ANSIT commandline arguments to run in
  42.                                auto-mode. Programmers should be interrested.
  43.  
  44.   FINAL WORD.................. How to reach me and my thanks.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                  OVERVIEW
  52.                                  ▀▀▀▀▀▀▀▀
  53.  
  54.     There are a lot of ANSI drivers on the PD/SW market, and most of
  55.     them are much faster then ANSI.SYS - but which one is the fastest?
  56.  
  57.     ANSIT! gives you the answer. It's a benchmark program testing how
  58.     fast your machine (or your current ANSI driver, actually) can
  59.     execute ANSI escape sequences, screen writes and scrolls.
  60.  
  61.     So load an ANSI driver and run ANSIT! You can compare different
  62.     ANSI drivers to see which one is the fastest on your machine.
  63.     Besides, it's fun. I tried to make this program look pretty,
  64.     not just execute.
  65.  
  66.     Is it really worth the trouble to test an ANSI driver, install
  67.     another one, reboot the machine, test it and so on ?
  68.     The answer is an unconditional: Yes!
  69.     Look at the file INDEX.RES. It's a result file produced by ANSIT
  70.     on a 12 MHz AT 286.  Four popular ANSI drivers are tested, and as
  71.     you can see, the fastest one does screen writes 4 times (!) faster
  72.     than the slowest one. Four times faster screen writes is worth some
  73.     trouble! (You could beep up the screen writes by using Shadow RAM
  74.     BIOS or a software BIOS, but it's preferable to use a ANSI driver
  75.     that takes care of this itself).
  76.  
  77.     Note however that the results in the INDEX.RES file is valid for
  78.     that machine only, don't take them for granted.
  79.     The same ANSI drivers may (and propably will) perform different
  80.     on your machine, with your graphics card and your setup.
  81.  
  82.     For the curious user I've included REF.RES
  83.     This is a result file for different machines, all tested with
  84.     ANSI.SYS loaded in a 'clean' setup. There is no need or real
  85.     interrest in compairing your machine to other machines but if
  86.     you want to do it for fun, look at this file.
  87.  
  88.     The ANSI driver you're testing must be able to handle most standard
  89.     ANSI sequences, but don't worry - I haven't seen one that doesn't!
  90.  
  91.     This program won't look that fancy on a monocrome monitor, you'll
  92.     need color to really enjoy it, but the test is just as valid.
  93.  
  94.     All in all, ANSIT is the complete ANSI workout. It tests everything
  95.     the ANSI driver does (with the exception of keyboard redefinition).
  96.     It also tests the speed of screen writes/scrolling so it can be used
  97.     to benchmark Software BIOS replacements as well as ANSI drivers.
  98.  
  99.     If you don't have a clear understanding on what a ANSI driver is
  100.     or how DOS handles screen output, I recommend you to read the ANSI
  101.     TUTORIAL file included (ANSITUT.DOC), right away.
  102.  
  103.  
  104.  
  105.                                  USAGE
  106.                                  ▀▀▀▀▀
  107.  
  108.     Program usage is simple, enter ANSIT <return> and you'll see
  109.     the first menu. Select ESCape to abort testing or <S> to start
  110.     the benchmark program. Five different tests are performed as
  111.     described below.
  112.  
  113.     When all the five tests are executed, you'll see a graph
  114.     displaying the current ANSI performance.
  115.     The 'Speed Index' values given represents the speed of your
  116.     machine's ANSI processing. Higher value = faster ANSI.
  117.     The Speed Index scale will not show the entire scale of 0 to 14.
  118.     Instead you will see the part of the scale valid to your machine.
  119.     That is, the scale could go from 0 - 6,  5 - 11 or whatever is
  120.     enough to display all your index values.
  121.  
  122.     Now you may choose to Exit or Write a report file to disk.
  123.     The reportfile option will create a textfile called ANSIT.REP
  124.     and write the Speed Index values for all tests to the file.
  125.     You will be asked to name the test, this isn't a filename but
  126.     a name written to the report file.
  127.     ANSIT checks for the existance of the reportfile before creating,
  128.     if it already exist, ANSIT will append to it. This will
  129.     create a neat table if more than one benchmark is executed.
  130.  
  131.     The built-in ANSI file display timer:
  132.     To display an ANSI animation or textfile, enter:
  133.     ANSIT <filename> [<times>]
  134.  
  135.     <filename>  is the name/path of the file to display.
  136.     <times>     is (optional) times to display the file.
  137.                 Default is 1 time.
  138.  
  139.     For further information on this function, see the next chapter.
  140.  
  141.     You may interrupt the benchmark by pressing Ctrl-C / Ctrl-Break.
  142.  
  143.  
  144.                            BENCHMARK DESCRIPTION
  145.                            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  146.  
  147.     What does this benchmark measure, really ?
  148.     It measures the time it takes for your machine to perform
  149.     different ANSI escape sequences, text and character output
  150.     and scrolling of the screen.
  151.     The speed of the computer does, of course, affect the result,
  152.     but the most important is the speed of the graphics card and
  153.     in particular the ANSI driver loaded. Needless to say, the
  154.     faster your machine/graphics card/ANSI driver can perform these
  155.     actions the faster screen output you'll get.
  156.     Benchmarks are often "theoretical". This is strait forward.
  157.     If a test is performed faster with one ANSI-driver than with
  158.     another, the output really IS faster. Simple and fool proof!
  159.  
  160.     Note that programs using direct screen writes is bypassing the
  161.     ANSI driver, writing directly to the screen. The ANSI performance
  162.     only affects applications writing to STDOUT and/or using ANSI
  163.     escape sequences. All DOS funtions does this, so the ANSI driver
  164.     performace does count when typing textfiles, displaying ANSI
  165.     files, directory listing etcetera.
  166.  
  167.     Now, let's examine the different tests in detail.
  168.  
  169.     The tests performed by ANSIT is as follows:
  170.     ---------------------------------------------------------------
  171.         Test 1:      Position Cursor.
  172.                      Test the ANSI escape sequence:
  173.                      Position Cursor        CUP  ESC[n;nH
  174.                      Set Graphics Rendition SGR  ESC[n;nm
  175.                      CUP an